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Yes, ProDOS is Now Being Shipped 


We bought an Apple //e last weekend, and it came with system 
disks for both DOS 3.3 and ProDOS. There was no DOS Reference 
Manual, although a little of DOS is mentioned in the Owner's 
Manual. There is a very nice ProDOS User's Manual, 150 pages 
of text and photos and drawings. The dealer says he still has 
no word on ProDOS as a separate product. 


I Can't Believe He Typed The Whole Thing! 


One of our readers took a few evenings and typed in the source 
code of the whole CX ROM from the Apple //e Reference Manual 
Addendum. This is the code from $C100 through SCFFC, which is 
listed on pages 23-49. He added some of his own comments to 
the source, which more fully explain what is going on in there. 
The source for the F8 ROM is on the disk too, but without many 
comments (pages 3-18 of the addendum). Naturally, the source 
files are in the format of the S-C Macro Assembler. 


We think having the source of these ROMs on disk could enhance 
the //e in two ways: you can make a larger size copy of the 
listings, so they can be read in normal room light; and you can 
experiment with improvements to the code. If you have a PROM 
burner that will burn 2764s, I think you can even replace the 
chips. If you'd like a copy, send us $15: we'll mail the disk 
to you, and pass along a percentage to the energetic typist. 


Listing Buried MesSageS.....cccceccccceeee BOD Sander-Cederlof 


Do you like treasure hunts? Dis-assembling, analyzing, 
understanding, and modifying programs written in assembly 
language, with nothing to go by but the program in memory and 
maybe a user's manual ... to me it is a treasure hunt. 


Last week I desperately need to make full use of a Novation Cat 
II Modem. "Full use” of almost any peripheral device implies 
the use of assembly language. Even though Novation includes a 
very nice manual for the purpose, it did not answer half my 
questions. 


Novation also includes a disk with a program called Com-Ware 
II. This program is assembly language, and takes 74 sectors on 
the disk. Somewhere, hidden in a small, dark corner, guarded 
by gnomes, surrounded by wild beasts, lay the answers to all my 
questions. 


I started by BLOADing the file. Then “CALL -151"° to get into 
the monitor, and typed "AA60.AA73". The first two bytes 
displayed the length of the file, and the last two bytes are 
the starting address. I learned it loaded at $900, and was 
$4825 bytes long. 


I started using the monitor L command to scan through the 
program, and discovered that the programmer had placed all the 
screen messages “in line”. That is, rather than putting all 
the screen text at the end of the whole program, or in the 
middle, or wherever, he coded the ASCII strings right in place. 
Each message was preceded by "JSR $3866", and ended with a $00 
byte. The subroutine at $3866 retrieved the return address 
from the stack, used it to address the message text while 
printing it out, and then placed a new return address on the 
stack to continue execution right after the $00 byte. 


This makes it difficult to use a program like Rak-Ware's 
wonderful DISASM, because you have to tell the boundaries of 
all non-executable code. And there seemed to be LOTS of 
messages. 


On the other hand, it also makes it easier to follow the flow 
of the program. The buried messages are almost like living 
comments, telling me exactly what is going on in every section 
of code. 


I decided to get my Apple to help. I wrote a “quick and dirty" 
program to scan through the whole image from $900 through 
$5125, looking for every occurrence of "JSR $3866". I printed 
out the address of the next byte, which is the first byte of 
message text. Then I searched for the terminating $00 byte, 
and printed out its address. Then I went back and printed out 
the message text. 


After several tries, I even made my quick and dirty program 
nice and clean. I printed all the messages out, nicely 
formated for easy visual scanning. I set my printer on 8 
lines/inch and 12 chars/inch to save paper, and let ‘er rip. 
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S-C Macro Assembler Version 1.O..cccccccccccccvcsccvccccsccccccnces $00.00 
S-C Macro Assembler Version 1.1 Update... ..cccccvcccccccccecvcveccee $l2.50 
Full Screen Editor for S-C Macro Assembler... .ccccccccccccccscccee $49.00 
Includes complete source code. 
S-C Cross Reference DELI CY cow ek 65h 666 ish we er oes eee eee es e20.00 
S-C Cross Reference Utility with Complete Source Code......cceeeee eo 990.00 
DISASM Dis-Assembler (RAR -WAlG) 6 idwine 005s 640666900554 00 eee 0000 e eo we oO. 00 
Quick-Trace (Anthro-Digital) ....ccccccccccccccccccee (rege $50.00) $45.00 
The Visible Computer: 6502 (Software Masters).......(reg. $50.00) $45.00 


S-C Word Processor (the one we USE!) .ccccccccccccccccvcvcccccsccsee gS D0L00 
With fully commented source code. 

Applesoft Source Code on Di GK ei os0 644 660 06 05 03 Kewanee eee seen ees 290600 
Very heavily commented. Requires Applesoft and S-C Assembler. 

ES-CAPE : Extended s-C Applesoft Program EGQLt Or secs ceneaccececese vs 660.00 


AAL Quarterly DISK 6c é 540646066 NS Sw ESS OWS 6458s SOs Ge 3 OACD $15.00 
Each disk contains all the source code from three issues of "Apple 
Assembly Line", to save you lots of typing and testing time. 


QD#1l: Oct-Dec 1980 QD#2: Jan-Mar 1981 QD#3: Apr-Jun 1981 
QD#4: Jul-Sep 1981 QD#5: Oct-Dec 1981 QD#6: Jan-Mar 1982 
QD#7: Apr-Jun 1982 QD#8: Jul-Sep 1982 QD#9: Oct-Dec 1982 


QpD#10: Jan-Mar 1983 
QD#13: Oct-Dec 1983 


QD#11: Apr-Jun 1983 QD#12: Jul-Sep 1983 


Double Precision Floating Point for AppleSOft....cccccccccccscccceee GI0000 
Provides 2l-digit precision for Applesoft programs. 
Includes sample Applesoft subroutines for standard math functions. 


Amper-Magic (Anthro-Digital) ...cccccccccecvecccccece (reg. $75.00) $67.50 
Amper-Magic Volume 2 (Anthro-Digital) .ccccccccccccee (LEG. $35.00) $30.00 
Routine Machine (Southwestern Data Systems)........-(reg. $64.95) $60.00 


FLASH! Integer BASIC Compiler (Laumer Research) ..cccccccvccccccccee SI 9000 

Fontrix (Data TranSf£OrMS) ..cccccccccccccscccccecscsccccsscccccscese $175.00 

Aztec C Compiler System (Manx Software)...cccccceee (rege $199.00). $180.00 

IACcalc Spreadsheet Program....cccccccccccsccccscccee (rEg. $84.95) $75.00 
The one we use every day. It's better than Visicalc! 


Blank DISKECTES ccc ccccccccccccccccccccccecscccce s package of 20 for $45.00 
(Premium quality, single-sided, double density, with hub rings) 

Vinyl disk pages, 6"%x8.5", hold one disk each....ccccccccceeelO for $6.00 
Diskette Mailing ProtectorS...ccrccccccccccsccccceecel0-99: 40 cents each 

100 or more: 25 cents each 

Cardboard folders designed to fit into 6"°X9" Envelopes. 

Envelopes for Diskette MailerS...c.ccccccccccccscccscssccceses 9 Cents each 
21IF Game Socket EMEGHOEL 64 6 66-66 6b 0S 060 6 OO SS 64s Oe one eee se ces 920.00 


Buffered Grappler+ Interface and 16K Buffer......eeeeee ($239.00) 
quikLoader EPROM CAY Gi. 65666066 6S 5 Sass 650s ee sone (9179450) 


$200.00 
$179.00 


Books, BookS, BOOkS..cccccccccccccccccccesee ecCompare our discount prices! 


Add $1.50 per book for US shipping. 


"The Apple J][{ Circuit Description", Gayler........e.e. ($22.95) $21.00 
“Understanding the Apple II", Sather....cccccccsecsee ($22.95) $21.00 
"Enhancing Your Apple II, vol. 1", Lancaster......2e.($17.95) $17.00 
“Incredible Secret Money Machine", Lancaster....ccesee ($7.95) $7.50 
"Beneath Apple DOS", Worth & Lechner...ccccccccscccee ($19.95) $18.00 
"Bag of Tricks", Worth & Lechner, with diskette......($39.95) $36.00 
"Assembly Lines: The Book", Roger Wagner.ceccccccceee ($19.95) $18.00 
"What's Where in the Apple", Second Edition.......+«+ ($24.95) $23.00 
“what's Where Guide" (updates first edition) ......eeee ($9.95) $9.00 
"6502 Assembly Language Programming", Leventhal......($18.95) $18.00 
"6502 Subroutines", Leventhal... .ccccccccccvcccccceces ($17.95) $17.00 


*** S-C SOFTWARE, P. O. BOX 280300, Dallas, TX 75228 *** 
kee (214) 324-2050 ket 
*** We accept Master Card, VISA and American Express *** 


Foreign orders add postage needed. 
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Six whole pages! I think a third of Com-Ware is taken up by 
messages ! 


Here is a sample of the printout. Notice that I printed 
control characters, including <RETURN>, as ““" followed by the 
printing form of the character. Thus °"M" means <RETURN>. 


1481...14CC “M°M<O> SET HIGH BIT“M<1> CLEAR HIGH BIT°M<2> LEAVE HIG 
H BIT ALONE “MCHOICE(0-2): 


14EF...1528 “M°M<0O> SEND LF AFTER CR°M<1> DO NOT SEND LF AFTER CR™M 
CHOICE (0-1): 


aes 


I believe a lot of programs of interest use a similar technique 
for message printing, and slight adaptation of my MESSAGE 
SEARCH program could help YOU find some buried treasure! 


1900 *SAVE S.MESSAGE SEARCH 
1020 # FIND ALL MESSAGES IN COM-WARE II VERSION 5.0-3 
1080 a ALL MESSAGES ARE PRECEDED BY "JSR $3866" 
1050 * AND END WITH A $00 BYTE: 
1970 & 20 66 38 <MSG> 00 
0000- 1090 MSG.PNTR  .EQ $00,01 
0002- 1100 END.PNIR — .EQ $02, 03 
FQ41- 1120 PRINTAX .EQ $F941 
FDED- 1130 COUT .EQ FDED 
FD8E= 11 0 CROUT .EQ $FD8E 
co00- 1120 KEYBOARD .EQ $C000 
C010- 1170 STROBE -EQ $C010 
0800- Ag 00 1190 FIND LDA £$900 COMWARE WAS BLOADED AT $900 
a nh nr 
0806- he 01 1220 STA (32 Orne 
0808- A5 00 1230 1 LDA MSG.PNTR 
O80A- C9 25 ~—s:12 CMP #$5125 COMWARE ENDS AT $5125 
ce eS, ies 
ot hn eee ma 
1290 #=---SEARCH FOR A $20 BYTE-------- 
0813- AO 00 ~=—-: 1300 2 LD 
a Ce Bll 
08 19- FO 05 1 39 BEQ . FOUND $20 
081B- 20 A7 08 1340 .3 JSR INC 
O81E- DOE 1330 BNE .1 » + ALWAYS 
1360 #---CHECK FOR $66, $38 AFTER $20--- 
0820- C8 1370 A INY 
0821- B1 00 1380 LDA (MSG.PNTR),Y 
082 - C9 66 1390 CMP #$66 
hoes ca aa TY 
0828- B1 00 1420 LDA (MSG.PNTR),Y 
ar an a 
1450 #---FOUND A MESSAGE !-------.--.-- 
O82E- A2 OA 1460 LDX #10 
ge oo Go kg Say ater 
a8; - 20 A7 08 1490 SR INC SKIP OVER THE $20, $66, $38 
0839- 20 A7 08 1500 JSR INC 
083C- 20 A7 08 1510 JSR INC 
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O83F- A5 01 1520 LDA MSG. PNTR+1 PRINT STARTING ADDRESS 
O841—- 8 63 1530 STA END. PNTR+1 
O843- AB O 1540 LDX MSG.PNTR 
0 4? 86 02 1320 STX END.PNTR 
O847- 20 41 FQ 1560 JSR PRINTAX . 
178 @o22-SEARCH FOR END OF STRING----- 
O84A- AO 00 1580 LDY #0 
O84C- BI O 1330 5 LDA (END. PHTR) Y 
O84E- FO 0 1660 BEQ . OUND END 
GB50- ES Og 1610 «NC ND. Pw 
ags}- Be 0} 1630 «EN iD. PwTRe 
1650 #=--<-FPOUND END OF STRING---------- 
0858-49 AE 1660 6 LDA #8 PRINT *..0* 
G8Sp- 20 ED FD 1860 © USK COUR PRINT THE END ADDRESS 
0863—- AS 0 1 80 LDA END. PNTR+1 
086 - A f 1710 LDX END.PNIR 
0 - 20 41 F9 1720 JSR PRINTAYX 
O86A=- AQ AO 1730 LDA #$A0 PRINT * " 
086C- 20 ED FD 1740 JSR COUT 
O86F- 20 ED FD eo JSR COUT 
0872= 20 ED FD 1760 JS 


ORT ge Bt 00 «1800 «7 LDA MSG. PNTR), Y 


08 7B- FO 24 ~—- 1810 BEQ . .-eEND OF STRING 

O087D- 09 80 1820 ORA #380 

O87F- C9 AQ ~—-: 1830 CMP #$A0 PRINTING CHARACTER 

0881- BO OA ~—_ 18410 BCS . .eeYES, GO PRINT IT 

0883- 09 40 1850 ORA #$40 ..eNO, CONTROL, CHANGE TO 
0885- 4 1860 PHA PRINTING FO 

088 ~- AQ DE 18 0 LDA #"*™ PRINT "*" FOLLOWED BE CHAR 
0888- E 1880 INX 

0889- 20 ED FD 1890 JSR COUT 

O88C- 68 1900 PLA 

O88D- 20 ED FD 1910 8 JSR COUT 

0890- E 1920 INX 

0891- 20 A7 08 1930 JSR INC ADVANCE MSG. PNTR 

0894- EO 37 1940 CPX #55 IS THIS LINE FULL? 

0896- 90 E 1950 BCC my .eeNO, KEEP GOING 

0898- A2 1 1960 LDX #24 ...YES, START NEW LINE 
O89A- 20 CA 08 1970 JSR MARGIN INDENT 

O89D- A200 ~=1980 LDX #0 

O8A1- 20 8E FD 2010 .9 JSR CROUT 

O8A4- 4C 08 08 2020 ; JMP . 

O8A7- E6 00 2080 INC INC MSG.PNTR 

O8A9- DO 02 ~=— 2050 BNE .1 

O8AB- £6 01 2060 INC MSG. PNTR+1 

O8AD- 60 2 0 1 RTS 

O8AE- AD 00 CO 2090 PAUSE LDA KEYBOARD ANY KEY PRESSED? 
O8B3- 8D 10 CO 2110 STA STROBE ...YES, CLEAR STROBE 
O8Bb- C9 BD 2120 CMP #$8D WAS KEY <RETURN>? 
O8B8- DO 0 2130 : .».NO, JUST A PAUSE 
O8BA- 4C Dd 03 2140 .1 JMP $320 «YES, ABO 

O8BD- AD 00 CO 2150 .2 LDA KEYBOARD ANY KEY PRESSED? 
O8CO- 10 F 2160 BPL .2 ~eeNO, KEEP WAITING 
08C2- 8D 10 CO 2170 STA STROBE ...YES, CLEAR STROBE 
O8C5- C9 8D = 2180 CMP #$8D WAS KEY <RETURN>? 
O8C7- FO F1 2190 BEQ . .»e YES, ABORT 

O8CA- 20 8E FD 2220 MARGIN JSR CROUT START A NEW LINE 

O8CD- A9 AO —- 2230 LDA #30 SKIP OVER (X) SPACES 
O8CF- 20 ED FD 2240 .10 JSR COUT 

O8D2- CA 2250 DEX 

O8D3- DO FA 2260 BNE .10 

O8D5- 60 2270 RTS 
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Peeking at the CATALOG.......ccccccccceseeeBObD Sander-Cederlof 


Have you ever wanted just a quick peek at the catalog entry for 
a file? Maybe you want to know where the track/sector list is? 
Or maybe you want to see if there are any control characters in 
the name? Or if the number of sectors is more than 255? You 
need to peek, because CATALOG won't tell you these details. 


After all these years, I found out a simple way to do it. That 
is, assuming you can OPEN, SAVE, LOCK, or otherwise somehow 
make DOS go looking for the file. 


After DOS has found the file, it leaves the directory sector 
containing the filename in the buffer at $B4BB-B5BA. DOS also 
leaves an index to the. very byte at which the information on 
your file is found. The value in $B39C, if added to the 
address $B4C6, gives you the address of the start of the entry. 
$22 bytes later it ends. 


A minute ago I saved the contents of this and a few other short 
articles on a file named V4N5 SHORT SUBJECTS. Then I left my 
word processor, typed CALL -151 to get into the monitor, and... 
Well, here, look for yourself: 


]CALL-151 

*B39C 

B39C- D2 (offset from B4C6) 
*C6+D2 

=98 (first byte of entry) 
*98+22 

=BA (last byte of entry) 
*B598.B5BA 

B598- OC OE 00 D6 B4 CE B5 AO 

B5A0- D3 C8 CF D2 D4 AO D3 D5 

B5A8- C2 CA C5 C3 D4 C3 AO AO 

BS5BO- AO AO AO AO AO AO AO AO 

B5B8- AO 07 00 


The first byte at B598 is the track, and the second is the 
sector, where the track/sector list for this file is stored. 
The third byte is the file type (00 means an unlocked text 
file). The last two bytes are the file size. All the bytes in 
between are the file name. 


If you are interested in the entry for a file you cannot reach 
directly, perhaps because there are hidden characters in the 
name, just LOCK, UNLOCK, or whatever a file above or below it 
in the catalog. Then peek at B39C and B4BB...B5BA to find the 
entry you are really interested in. 


We also took advantage of the fact that the track/sector list 
of a file read or written on can be found at the beginning of 
the file buffer. If there are three buffers (MAXFILES=3), and 
if the file in question was the only one being accessed at the 
time, the T/S list will be found at $9600...S96FF. You can get 
the data you need immediately, without even finding your 
favorite ZAP utility. 
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Appleseed is a complete computer system. It is designed using the bus 
conventions established by Apple Computer for the Apple ][. Appleseed is 
designed as an alternative to using a full Apple ][ computer system. The 
Appleseed product line includes more than a dozen items including CPU, 
RAM, EPROM, UART, UNIVERSAL ‘Boards as well as a number of 
other compatible items. This ad will highlight the Mother board. 


BX-DE-12 MOTHER BOARD 


The BX-DE-12 Mother board is designed to be fully compatible with all of 
the Apple conventions. Ten card slots are provided. Seven of the slots are 
numbered in conformance with Apple standards. The additional three 
slots, lettered A, B and C, are used for boards which don’t require a 
specific slot number. The CPU, RAM and EPROM boards are often placed 
in the slots A, B and C. 


The main emphasis of the Appleseed system is illustrated by the Mother 
Board. The absolute minimum amount of circuitry is placed on the Mother 
Board; only the four ICs which are required for card slot selection are on 
the mother board. This approach helps in packaging (flexibility & smaller 
size), cost (buy only what you need) and repairability (isolate and fix pro- 
blems through board substitution). 


Appleseed products are made for O.E.M.s and serious industrial/scientific 
users. Send for literature on the full line of Appleseed products; and, watch 
here, each month, for additional items in the Appleseed line. 


Appleseed products are not sold through computer stores. 
Order direct from our plant in California. 
Apple is a registered trademark of Apple Computer, Inc. 


DOUGLAS ELECTRONICS 
718 Marina Blvd., San Leandro, CA 94577 © (415) 483-8770 
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Clarification about our copyrights.........Bob Sander-Cederlof 


We frequently are asked if it is all right to use ideas and 
even programs published in the Apple Assembly Line in articles 
or books our readers write for publication elsewhere, or even 
in software they plan to sell. 


Sure! Just give us credit. Say where you got it, and 
hopefully tell your customers how they too can subscribe. The 
more you sell, the more we sell. The more we spread the good 
information around, the more we all benefit. 


Fast Scroll for Ife B8O0—-column...-.ccceceececee eBOD Sander-Cederlof 


The //e 80-column firmware scrolls in an annoying fashion. If 
‘you are trying to watch a listing go by, it looks like a bunch 
of kids on the playground, jumping up and down. And it is 
slower than almost any brand of 80-column card that plugs into 
slot 3. 


The “slot 3" kind of 80-column card usually has a general 
purpose CRT controller chip on it. These chips use a 
wrap-around memory, and have one register that tells the chip 
where in memory to start the screen display. Scrolling is 
instantaneous, because it only involves writing a new address 
into two registers. 


The //e 80-column card has no built-in features at all. All it 
is, is plain old RAM. A few extra circuits allow alternate 
columns to be taken first from the mother board and then from 
the 80-column card, back and forth. And the video rate is 
doubled, so 80 columns appear on each line. The scroll routine 
moves the whole screen up in two steps. First all the odd 
columns {in main memory) are moved up, and then all the even 
columns (in 80-column card memory). That is why you see the 
zig-zag effect. 


The scroll is slower than a 40-column scroll by a factor of 
two. After all, it is essentially the same code, just called 
twice. 


As I said in my article on fast scrolling in the September 1982 
issue of AAL, you have to bear in mind that the authors of the 
programs in Apple ROM were not usually aiming for speed. They 
were trying to squeeze as much as possible into that tiny 
space, and make it as general as they could. The //e 80-column 
firmware supports windows smaller than a full screen, and that 
is seldom found in other types of 80-column cards. 


On the other hand, since I am used to not having nice windows 
in the other cards, I can live with that in the //e. And I am 
having a hard time adjusting to that see-saw slow-motion 
scroller. 


So, I re-wrote all the fast screen tricks from the September 
1982 article to work in the //e with the Apple 80-column card. 
It scrolls as smooth as glass, but I still can't read it: now 
it's too fast! 
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1000 # S.SCREEN TRICKS //E 80-COLUMN 

1020 # FAST SCREEN CLEAR SUBROUTINE 
0800- AQ FF 1080 GCLEAR LDA #25 
0802- 2C 1050 HS SKIP OVER NEXT TWO BYTES 
0803- AS AO =—«-: 1060 CLEAR LDA #$A 
0805- AO 77 1070 SET LY #119 
ae ae ee eye ee 
o80C- 99 00 O4 1100 STA $400,£ LINES: 0 8 16 
O80F- 99 00 05 1110 STA $500,Y 210 18 
0812- 99 00 06 1120 STA $600,Y 4 12 20 
0815- 99 00 0 1130 STA $700,Y 6 1h 22 
0818- 99 80 O4 110 STA $480°Y¥ 1917 
081B- 99 80 05 1150 STA $580,Y 311 19 
O81E- 99 80 06 1160 STA $680,¥ 5 13 21 
0821- 99 80 07 1170 STA $780,Y 7 15 23 
O824- CA 1180 DEX 
eo nn 
OB26- 10 DD 1210 BPL .1 
O82A- 60 1220 RTS 

1240 : SET SCREEN TO ALL VALUES 
082B- A9 00 1280 SETALL LDA #0 
Be gos oe tag pie am 
oh or 
OB 3 BO re (336 BNE .1 
0837- 60 1330 RTS 

1350 ® ALTERNATE SCREEN UNTIL KEY PRESSED 
0838- Ag 2 1370 ALTER LDA £$20 INVERSE BLANK 
te aE aE? 
OBO- AD OB GO 1400 LDA $C000 
0843- 10 1410 BPL ALTER 
og43- D 10 CO 1420 STA $C010 
0848- 60 1430 RTS 

1450 # FAST SCROLL UP SUBROUTINE 
0849-40 00 1470 SCROLL LDY #0 
SBuD- BD Sh CO 1490 23 ba $054, x 
0650~ B 00 O4 1560 : LDA A SAVE LINES: 0 8 16 
ORere be Co Gk Wes0 A SMe ee ee 
Sak Be oe tee ERE wre ms, tos, soo 
0860~ B9 80 05 1380 LDA 80,¥ MOVE 3>2, 11>10, 19>18 
OBES. 69 BO 08 1360 LDA $600,% MOVE 423, 12911, 209 
O86C- BI 80 0 1280 LDA $680,Y¥ ET CETERA 
O86F- 99 00 06 1610 STA $600,Y 
a eet 
SE ee 
OR TB 28 1020 PLA "MOVE 8>7, 16>15 
OB7F- CO 28 1670 CPY #40 
0881- 90 0 ” 16 0 BCC a ,PESCARD OLD LINE 0 
ORR ek 1700 .2 DEX . 
0887- 10 Ch 1710 BPL .3 
Opaa. cb 7a tae SPY #120 
ORBAN 90 BD isto BCC .1 
O88E- 60 1750 RTS 
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4760 Bscececcieereetcnteencsdscsccucus 
770 ® SCROLL AROUND, MOVING TOP LINE TO BOTTOM 
O88F- AO 2] 1790 SCR _LDY £39 SAVE TOP LINE ON STACK 
OReke aS 30 O8 1810 aa keaeY 
O89 7- Ba 1316 PHA : 
0898- AD 55 CO 1830 LDA gC055 
08 9B- i 00 O84 18h0 LDA 400,Y 
OR OE. 4 1330 DEY 
O8A0- 10 BF 1870 BPL .1 
O8A2- 20 49 08 1880 JSR SCROLL SCROLL SCREEN UP ONE LINE 
BBE Ao OB on BBB 2 ERE {Zon STORE OLD TOP Lins 
O8AA- éb 1910 P ON BOTTOM OF SCREEN 
O8AB- 99 DO 07 1920 STA 7D0,¥ 
Of AR Ap 54 CO 1930 LDA $CO05 
O8B2- 99 DO 07 1950 STA $7D0,Y 
OpBe- 65 og hae SPY #h0 
OR Be 90 1840 BCC .2 
O8BA- 60 1990 RTS 
20 10 . ROTATE SCREEN UNTIL KEY PRESSED 
O8BB- 20 8F 08 2030 s JSR SCR SCROLL AROUND ONCE 
O8BE- AD 00 CO 2040 LDA $CO00 ANY KEY PRESSED? 
08c1- Jo F8 2050 BPL NO, SCROLL AGAIN 
08C3- 8D 10 CO 2060 STA $C010 YES, CLEAR STRO 
O8C6- 60 2070 RTS .ee AND RETURN 


DOS 3.3 Checksummer Debate Update..........Bob Sander-Cederlof 


A letter from Bill Basham (Diversi-DOS author) defending the 
practice of omitting the automatic VERIFY after SAVE to gain 
speed, was published in the September 1983 Softalk (page 37, 
38). At the top of page 38 Bill claimed that the checksumming 
method used by DOS was of no value at all, because the checksum 
only depended on the last two bytes. In other words, Bill 
Claims that errors in the first 340 bytes of a sector will not 
be caught. 


Diversi-DOS is a fine product, and many thousands are enjoying 
its advantages. Nevertheless, Bill is wrong about the 
checksum. It does indeed catch errors throughout a sector. 
For a complete explanation, see the February 1984 Softalk. 
David Wagner clearly explains how the checksummer works, and 
refutes Bill's claim. See his letter on page 40. 


You can look at the code, too. We printed a full commented 
source listing of this code in the June 1981 issue of AAL. 
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So That'S a MacintOSh!. cc cccccccccccvccccccccccceceeBill Morgan 


Well, now we know. The rumors were basically correct: 68000 
processor, 128K RAM, 3.5 inch disk drive (but only one), 
portable, Lisa descendant, about $2500, and no expansion slots. 


That last “feature” still has me a little shaken. I thought 
that if anybody knew better, it would be Apple, whose whole 
fortune is based on the expandability of the Apple ][. My 
first reaction was totally negative: who wants to bother with 
a dead-end machine? A total of 128K of RAM, and the screen 
memory occupies over 20K. Now that I've read a little more 
about the internals, and about the design objectives, things 
look a lot brighter. The on-board memory will be expandable to 
512K when the 256K chips get more affordable. 


System expansion will take place via the high-speed RS-422 
serial ports. One of the designers pointed out that at 1 
million bits per second (which can be reached with external 
Clocking) you can transfer the entire memory image of the 
machine in one second. A couple of manufacturers (Davong and 
Tecmar) have already announced hard disks. Tecmar also 
announced an IEEE 488 interface. Macintosh designers also 
speak of “virtual slot” protocols for the serial ports, and 
“multi-drop (party line) capability". 


There's another departure from usual Apple practice: no 
programming language is resident in the machine, or included in 
the purchase price! Several options will be available, 
including Pascal, Mac Basic, Microsoft Basic, Logo, and an 
Assembler/Debugger. The prices for the above packages will run 
in the $100-$150 range, not too bad. One article also 
mentioned C, about six months from now. It wasn't clear 
whether that was from Apple or an outside vendor. All of the 
above languages are scheduled for release in the next few 
months, except for Microsoft Basic. Russ Weaver, at 
Simtec/Quest, tells me he received that yesterday. 


There is also 64K ROM (two 23256's) in the Mac, which holds the 
key to most programming. That ROM contains the code to support 
the “desk top" environment of mouse, icons, etc., the disk I/O, 
and the serial I/O. That is supposed to be 64K of the most 
tightly coded 68000 machine language around (as opposed to 
Lisa's compiled Pascal operating system code). I am told that 
there are over 400 entry points available to the programmer, 
with complete documentation coming soon from Apple for $250. 


Several information sources have already popped up. If you 
haven't seen the February issue of Byte, go get it. There is a 
large section on Mac, including the best technical data so far. 
There are already two magazines specializing in Macintosh: 
Macworld, from the publishers of PC World, and ST.Mac, from 
Softalk. (Saint Mac? Come on.) Macworld looks very good, 
especially for evaluation and demonstration of software. I 
haven't seen a copy of ST.Mac yet, but Softalk is about the 
best of the “general" Apple magazines so I expect good things 
from their entry. You can pay $2495 for a Macintosh serial 
number and get a year's free subscription to ST.Mac. 
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Reminder about Wrap-Around AddresSing....cccccceeeBill Parker 


Buried on the right side of page 65 of the November, 1983 issue 
of Call APPLE is the examination by Martin Smith of another 
quick of the 6502. I say “another quirk" because it is similar 
to the JMP indirect wrap-around bug. Remember it? 


As reported in the October 1980 issue of Apple Assembly Line, 
"“JMP (SxxFF)* will not jump to the address pointed to by the 
two bytes beginning at $xxFF; rather the two bytes at $xxFF and 
$xx00 will be used. (Where xx means any page of memory. 


A similar wrap-around situation can be found when indexing like 
this: 


STACK .EQ $100 
LDX #1 
LDA STACK-1,X 


Since STACK-l1 is SFF, a page zero address mode is assembled. 
Indexing from within page zero never leaves page zero, so the 
above example references location $0000 rather than $0100. 


The above is important, because many programmers use it ina 
“WHEREAMI® section of code to find the program's current 
address: 

STACK -EQ $100 | 

WHEREAMI JSR $FF58 (known RTS instruction) 


TSX 
LDA STACK-1,X get PCL 
LDY STACK,X get PCH 


For the Merlin Assembler, the problem can be corrected by 
forcing the assembler to use an absolute addressing mode rather 
than a page zero addressing mode. This is done by suffixing a 
“:"* to the opcode, like this: 


LDA: STACK-1,X 
The S-C Assemblers have no syntactical way to force absolute 


mode, but it can be done by defining the symbol STACK after its 
use. Here's an interesting example: 


0800- BD FF 00 1000 LDA STACK-1,X 
0100- 1010 STACK .EQ $100 
0803- BS FF 1020 LDA STACK-1,X 


Since the assembler doesn't know the value of STACK in the 
first line, it has to assume it will be a two-byte address, and 
allocate that much space. By the time it gets to the last line 
it knows better. 


The fact that indexing wraps around inside page zero is a plus 
sometimes. (I guess that explains why the chip works that 
way!) It has the effect of letting you use both positive and 
negative index offsets. Just beware of getting so used to 
negative offsets that you try to use them OUTSIDE page zero! 
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---------------------- APPLE SOFTWARE ----------------------- 


NEW!!! FONT DOWNLOADER & EDITOR ($39.00) 

Turn your printer into a custoa typesetter. Downloaded characters resain active while printer is powered. Can be used 
with every word processor capable of sending ESC and control codes to the printer. Switch back and forth easily between 
standard and custos fonts. All special printer functions (like expanded, coapressed, eaphasized, underlined, etc.) apply 
to custoa fonts. Full HIRES screen editor lets you create your own custoa characters and special graphics syabols. 
Coapatible with aany ‘duab’ & ‘seart’ printer I/F cards. User driver option provided. Specify printer: Apple Dot Matrix 
Printer, C.Itoh 8510A (Prowriter), Epson FX-B0/100 or Okidata 92/93. 


DISASM 2.2e - AN INTELLIGENT DISASSEMBLER ($30.00) 

Investigate the inner workings of eachine language prograas. DISASH converts 6502 aachine code into aeaningful, syebolic 
source. Creates a standard DOS 3.5 text file which is directly coapatible with DOS ToolKit, LISA and S-C (4.0 and MACRO) 
asseablers. Handles data tables, displaced object code & even lets you substitute your own eeaningful labels. (100 
coaaonly used Monitor & Pg Zero pg names included.) An address-based cross reference table provides further insight into 
the inner workings of aachine language prograas. DISASH is an invaluable aachine language learning aid to both the 
novice & expert alike. SOURCE codes #60.00 


S-C ASSEMBLER (Ver4.0 only) SUPPORT UTILITY PACKAGE ($30.00) 
# SC. XREF - Generates a GLOBAL LABEL Cross Reference Table for coaplete docusentation of source listings. Foraatting 
control accoaodates all printer widths for best hardcopy outputs. # SC.GSR - Global Search and Replace eliainates 
teadious aanual renasing of labels. Search all or part of source. Optional proaptiag for user verification. # SC.TAB - 
Tabulates source files into neat, readable fore. SOURCE code: $40.00 


~--~----~------------ HARDWARE/FIRMWARE ---------------+------ 


THE °“PERFORMER’ CARD ($39.00) 

Plugs into any Apple slot to convert your ‘duab’ centronics-type printer I/F card into a ‘saart’ one. Cosaand senu 
provides easy access to printer fonts. Elisinates need to remeaber coaplicated ESC codes and key thea in to setup 
printer. Added features include perforation skip, auto page nuabering with date & title. Also includes large HIRES 
graphics screen duap in noraal or inverse plus full page TEXT screen duap. Specify printer: Epson AX-80 with 
Graftrax-60, NX-100, MX-80/100 with GraftraxPlus, NEC 80923A, C.Itoh 8510 (Prowriter), OkiData 82A/83A with Okigraph & 
OpkiData 92/93. Oki bonus: print EMPHASIZED & DOUBLE STRIKE fonts!’ GOQURCE codes $30.00 


FIRMWARE FOR APPLE-CAT: The ‘MIRROR’ ROM ($25.00) 

Coaaunications ROM plugs directly into Novation’s Apple-Cat Modea card. Three basic aodes: Duab Terainal, Reacte Console 
& Prograssable Modea. Added features includes selectable pulse or tone dialing, true dialtone detection, audible ring 
detect, ring-back option and built-in printer buffer. Supports eost 80-coluan displays and the !-wire shift key aod. 
Uses a superset of Apple's Cosa card and Nicroaodea I] commands. A-C hardware differences prevent 100% cospatibility 
with Coa card. SOURCE codes $60.00 


RAM/ROM DEVELOPMENT BOARD ($30.00) 

Plugs into any Apple slot. Holds one user-supplied 2Kx8 aesory chip. Use a 6116 type RAM chip for prograa developsent or 
just extra aeasory. Plug in a preprogrammed 2716 EPROM to keep your favorite routines ‘on-line’. A versatile board with 
aany uses! Maps into $Cn00-CnFF and $CB00-CFFF aeaory space. Circuit diagrae included. 


NEW!!! SINGLE BOARD COMPUTER KIT ($20.00) 

Kit includes etched PC board (with solder sask and plated thru holes) and asseably instructions. User provides 6502 CPU, 
6116 2K RAM, 6821 dual 8-bit 1/0 and 2732 4K EPROM plus isc comaon parts. Originally designed as intelligent printer 
interface - easily adapted to eany applications needing dedicated controller. (Asseabled and tested: $119.00) 


All asseably language SOURCE code is fully coamented & provided in both S-C Asseabler & standard TEXT foraats on an 
Apple DOS 3.3 diskette. Specify your systea configuration with order. Avoid a $3.00 postage and handling charge by 
enclosing full payaent with order (MasterCard & VISA excluded). Ask about our products for the VIC-20 and Coasodore 64! 


RAK -WA RE 
41 Ralph Road West Orange NJ 07052 (201) 325-1885 


Apple Assembly Line....February, 1984....Copyright (C) S-C SOFTWARE....Page 13 


Delays, delayS, delayS....cccccccccecceceeeBObD Sander-—Cederlof 


We always want speed. Making computers compute faster keeps 
our industry humming. Yet nearly every major program has 
pieces of code called delays. 


We use them to generate carefully controlled, timed events: 
for example, generating a musical tone. We use them to 
synchronize events, or to provide time for external events to 
occur. We even use them just to slow the computer down s0 we 
can watch it work. 


Delays are used so often that Woz had the foresight to put a 
general purpose delay subroutine permanently inside the monitor 
ROM. It resides at S$FCA8. It is short (only 12 bytes), sweet 
(only uses one register, the same one which controls how long a 
delay you get), and slow (on purpose). Here is a listing: 


WAIT SEC PREPARE TO SUBTRACT 

ol PHA SAVE A COPY OF A-REG 

02 SBC #1 COUNT A-REG DOWN TO ZERO 
BNE .2 »« UNTIL A=0 
PLA GET SAVED COPY OF A-REG 
SBC #1 COUNT THIS COPY DOWN TOO 
BNE .1 ~- UNTIL A=0 
RTS 


To use this subroutine, you load the A-register with a value 
which will determine the length of the delay, and then JSR 
WAIT. When the subroutine returns, A=0 and somewhere between 
29 and 167309 clock cycles have elapsed. The formula, somewhat 
confusingly printed on page 165 of the white Apple II Reference 
Manual (and elsewhere in other manuals), is: 


# cycles = (5*A*A + 27*A + 26)/2 


For an example of its use, look in the monitor listing at S$FBDD 
(the bell routine). Examples of other timing loops are found 
in the tape cassette I/O routines ($FCC9-SFDOB) and the paddle 
reading subroutine (SFBIE). 


Bill and I spent the last two weeks working with software which 
Surrounds the Novation Cat Modem. It is loaded with calls on 
the monitor WAIT subroutine. It is exceedingly tiresome to 
Crank out a formula like the quadratic above by hand, or even 
with a calculator, over and over and over, when you have 
several Apples sitting in the same room! 


After four or five trips to the manual and the calculator, I 
decided to work out the times for all possible values of the 
A-register. Once and for all. 


Here is a little Applesoft program which does the job, and 


elsewhere in this AAL you will find a full page showing all the 
cycle counts. | 
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1000 REM $FCA8 DELAY TIMES 

1005 DIM P$(256) 

1010 BL$ = ® ":BR$ = : FOR A = 1 TO 256 

1015 IF A = 65 THEN BL$ 

1016 IF , = 193 THEN BR Re = 

1020 T= (A fA 3,7 5 +A 37 + 6) /2 

1030 X = A: IF A = 256 THEN X 

1040 X$ = RIGHT$ (" "+ STR ( 3) 

1050 TR$ = RIGHT R$ (T + 1600 dy 0) ,3):2, :T = INT (T / 1000):TL$ = RIGHT$ 
nm 4 SRE (1), 3):T8 = TLE + TRS 

one soe. ne as as 7 *(L>9) 
s > 4 = & 

1050 H$ = "$" 4+ CHR$ (H + iy + cHRS (L + 48) 

et Ay, = H$ + BL$ + X$ + BR$ + 

2000 FOR I = 1.TO 64: PRINT P$(I)" "P$(I +64)" *P$(I + 128)" »& 

pect + 192): NEXT ‘ $ + 


The A-register values are given in both hex and decimal. The 
delay count is given in thousands of cycles. Each cycle is 
close to one microsecond, so you could think of the counts as 
being in milliseconds. 


The purists among you will want to multiply these cycle counts 
by the ACTUAL clock period (.9799268644 microseconds average, 
according to Sather) to get ACTUAL time. 


RWTS in DOS or ProDOS also give lessons in the use of precise 
delays. You will find weird little pieces of code which make 
no sense whatever inside RWTS. Things like PHA followed 
immediately by PLA, followed by a NOP. These are usually just 
delaying tricks. A PHA-PLA pair takes exactly seven cycles, a 
NOP 2 more. There is a delay while waiting for the motor to 
come up to speed. Another while stepping the head from track 
to track. 


These last two are intertwined, so that delays used while 
stepping across tracks count towards the total delay required 
to get the disk rotating at 300 rpm. 


Don Lancaster in his Enhancing the Apple books makes good use 
of delays in synchronizing graphics generation with the CRT. 

By updating a picture in one graphics page while displaying 
another, and then switching pages, you can get pretty 
impressive animation. However, the page flipping operations 
sometimes splatter the display. Using delays just right, you 
can make the switching occur when it won't be noticed. You can 
even mix graphics into the middle of a text screen or vice 
versa, or mix hi-res and lo-res on the same screen. 


Jim Sather in “Understanding the Apple II" also uses delays to 
control the screen switches in interesting ways. Jim figured 
out exactly how many cycles everything in the video generation 
Circuitry takes. Using his programs you can even use hi-res to 
draw underlines on text screens! A horizontal scan takes 
exactly 65 clock cycles. A vertical scan takes exactly 17030 
cycles. The following program, adapted from one given on page 
3-16 of Sather's book, splits the screen between hi-res and 
lo-res. Tapping the space bar moves the boundaries of the 
split. Play with it! 
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1000 ®SAVE SATHER 3-16 
1020 ® HTRES-LORES SPLIT 
19 0 : SATHER 3-1 
Cc000- 1050 KYBD -EQ $C000 
C010~ 1060 STRB EQ $C010 
C050- 1070 GRAPHICS .EQ $C050 
C051- 1080 TEXT EQ $C051 
C052= 1090 NOTMIXED .EQ $C052 
COD s- 1100 PAGE1 -EQ $C054 
C056- 1110 LORES EQ $C056 
1130 : TOGGLE HI/LO-RES EVERY 8515 CYCLES 
1150 OR $300 
0305- AG 22 GO Hiro ree Eby WOrmaxep 2/LO PAGE 
0 OB AC 50 CO 1180 . LDY GRAPHICS 
0309- AO Al 1200 SLEW LDY #39 2) SLEW SCREEN IF KEY PRESSED 
030B- 20 2B 03 1210 JSR WAITX10 330) 6#65+7 CYCLES 
O30E~ AC 10 C 1220 . LDY STRB 
0311- AC 00 CO 13ho KEYCHK LDY KYBD h) ANY KEY PRESSED? 
0314- 29 F3 1250 BMI SLEW 2 OR 3) YES, SLEW ONE LINE 
0316- 8? 01 1260 ADC #1 2 MAKE ALTERNATING O AND 1 
0318- 01 1270 AND #1 2 
031A- AA 1280 TAX 2 REMEMBER, 0 OR 1 
0 1B- BC 36 co 1290 LDY LORES , X LORES IF X=0, HIRES IF X=1 
0320- 20 3 03 1319 JSR WAITX1K (8000) 
0323- AO 1320 LDY #49 2) 
0338 2 2B 03 1390 JSR WAITX10 33. 
0329- 90 E6 sd - BCC KEYCHK 3 .. ALWAYS 
1370 (8515) 
1390 § 
1880 # TIMING ROUTINES 
1010 Geeedetncncccdaawenecuetecceeeenn 
1420 @ 
4439 fe--WAIT 10Y CYCLES------~~------ 
1440 #---(INCLUDING JSR) -------------~ 
032B- 86 1139 WAITX10 DEY 2) WAIT Y-REG TIMES 10 
e355 kw) kr 
gee ot RB? on 2 
1520 
1339 Coma AIT 1000X CYCLES -wweeecennn] 
1540 @---(INCLUDING JSR) -------------— 
0333- 48 1320 LOOP1K PHA 
0334- 68 1560 PLA 
ae Be 
0337—- AO 62 1590 WAITX1K LDY #98 2) WAIT X-REG TIMES 1000 
: 39—= a 2B 03 1500 JSR WAITX10 ff 80 ) 
033D- CA 1620 DEX 2 
033E- DO F3 1630 BNE LOOP 1K 2 OR 2) 
0340- 60 1640 RTS ) 
1650 Sxessssccc cc ccccwciecneesndenceene 
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0341- AD 50 CO 
O344- AD 00 CO 
0 rte 0 05 
0349- 8D 10 CO 
034C- 30 03 
O34E- EA 

O34F- 10 00 
0351= 20 64 03 
O354- EA 

0355=- EA 

0359- 29 61 03 
035¢- 18 

035D- 90 00 
035F- 90 E0 
0361- 48 

0362- 68 

0363- 

0364- 60 


and 1964. $80. 


$50 each. 
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& HORIZONTAL SPLIT 
: BY BOB SANDER-CEDERLOF 
ik eames fh 
SE 
LDA KY : 4 E IF SHOULD SLEW 
STA STRB m 
BMI .3 3 
| NOP 2) 
BPL .3 
3 JSR DLY12 2 3 
NOP 2 2 
. NOP 2 2 
. (32 33) 
LDA TEXT (4) 
JSR DLY21 21) 
CLC 2 
BCC .2 3 
22 BCC HSPLIT 3 
e >, asa 
® (33) 
| a ee > Gb Gb Gp &> &> Gp GP GD &> GD GD > > > > @> Gp Gp GP Gp G> = a> GG» GD 
# JSR DLY.. 6 (6) 
DLY21 PHA 3 
PLA 
OP 2 
DLY12 RTS 6 (6) 
e (21) (12) 


Complete, Commented Source Code! 


Our software is not only unlocked and fully copyable 
...we often provide the complete source code on 


S-C Macro Assembler. The key to unlocking all the 
mysteries of machine language. Combined editor/ 
assembler with 29 commands, 20 directives. Macros, 
conditional assembly, global replace, edit, and more. 
Highesi rating “The Book of Apple Software” in 1983 


Powerful cress-assembler modules also available to 
owners of S-C Macro Assembler. You can develop soft- 
ware on your Apple for 6800, 6805, 6809, 68000, 8085, 
8048. 8051, 1802, LSI-11. and Z-80 microprocessors. 


SC Xref A support program which works with the S-C 
Macro Assembler to generate an alphabetized listing of 
all labets in a source file. showing with each label the 
the line number where it is defined along with all line 
numbers containing references to the label. You get the 
complete source code for this amazingly fast program, 
on disk in format for S-C Macro Assembler. $50. 


Pull Screen Editor. Integrates with the built-in line- 
oriented editor in the S-C Macro Assembler to provide 
a powerful full-screen editor for your assembly lan- 
guage source files. Drivers for Videx. STB80, and Apple 
/fe 80-column boards are included, as well as standard 
40-column version. Requires 64K RAM in your Apple. 
Complete source code on disk included. $50. 


disk, at unbelievable prices! 


S-C Docu-Mentor for Applesoft. Complete documenta- 
tion of Applesoft internals. Using your ROM Applesoft, 
produces ready-to-assemble source code with full 
labels and comments. Educational, entertaining, and 
extremely helpful. Requires S-C Macro Assembler and 
two disk drives. $50. 


S-C Word Processor. The one we use for manuals, 
letters, our monthly newsletter, and whatever. 40- 
columns only, requires lower-case display and shiftkey 
mod. Works with standard DOS text files, but at super 
fast (100 sectors in 7 seconds). No competition to 
WordStar, but you get complete source code! $50. 


Apple Assembly Line. Monthly newsletter published 
since October, 1980, for assembly language pro- 
grammers or those who would like to be. Tutorial arti- 
cles, advanced techniques, handy utility programs, 
and commented listings of code in DOS, ProDOS, and 
the Apple ROMs. Helps you get the most out of your 
Apple! $18/year. 


$-C SOFTWARE CORPORATION 
2331 Gus Thomasson, Suite 125 
Dallas, TX 75228 (214) 324-2050 


Professional Apple Software Since 1978 
Visa, MasterCard. American Express. COD accepted 
Agpie = 8 (radenan 0 Appie Computer inc 
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Annotated 68000 Bibliography.....cc.ccccscccccecveceeeBill Morgan 


Here is a quick look at some of the books and articles about 
the 68000 that I have found to be helpful. 


Another possible source of 68000 information is the newsletter 
“DTACK Grounded", published by Digital Acoustics, 1415 E. 
McFadden, Suite F, Santa Ana, CA 92705. I've only seen one or 
two issues, back before I got interested in 68000, so I don't 
know exactly what they've been up to lately. I'll be finding 
out soon and pass it on. I might note that the issue I have 
(#7, Feb-Mar 1982) contains about 12 pages of more-or-less 
interesting gossip, and no code. I don't know if that is 
typical. 


Books: 


68000 Assembly Language Programming. Gerry Kane, Doug Hawkins 
& Lance Leventhal. OSBORNE/McGraw-Hill, 1981. 
The Leventhal book. Need I say more? Recommended. 


The 68000: Principles and Programming. Leo. J. Scanlon. 
Blacksburg/Sams, 1981. 
Tutorial. Looks pretty good. Recommended. 


MC68000 16-bit Microprocessor User's Manual, third edition. 
Motorola/Prentice-Hall, 1982. 
Motorola's manual. THE basic reference. There is a fourth 
edition coming this year (1984). There is also a Mostek 
version of this book, but the Motorola edition is better. 


MK68000 Microcomputer Programming Reference Guide. Mostek 
Corp, 1981. 
A 42-page Quick Reference Card. Isn't that a bit much? 


Programming the M68000. Tim King and Brian Knight. 
Addison-Wesley, 1983. 
Tutorial. Looks very good. Lots of examples, building up 
to a simple monitor/debugger. Recommended. 


Articles: 


Design Philosophy Behind Motorola's MC68000. Thomas W. Starnes 
(of Motorola, Inc.) Byte. April-June, 1983 (3 parts). 
Very good. Lives up to the title. Recommended. 


68000 Instructions and Addressing Modes. Joe Hootman. Micro. 
#'s 52,54-57,60-62 (8 parts). 
Summaries of the inatruction set. OK if you already have 
the stack of Micro back issues. 


An MC68000 Overview. Joe Jelemensky & Tom Whiteside. Micro. 


#'s 52,54. 
Some good examples of the instructions at work. 
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Table of //e Soft Switches......ccececcccscee BOD Sander-Cederlof 


For some reason none of the //e manuals I own give a complete 
chart in one place of all the new soft switches. If I print 
one here, I'll have one when I need it, so that's what the 
first chart on the following page is. 


I have ordered them according to the location you peek at to 
find which position the soft switch is in. The first column is 
the location you read. The sense of the switch is given by bit 
7 of the byte you read, and that bit's value is given at the 
top of the next two columns. 


Note that there is an error in the Apple //e Reference Manual, 
on both pages 133 and 214, where the SLOTCXROM soft switch is 

described. In both places, the slot/internal designations are 
backwards. It looks like the book was written rationally, and 
the circuit behaves irrationally, because the SLOTC3ROM switch 
aa the opposite manner from the SLOTCXROM switch. Oh 

we eee 


The maze of information choy ghar the bank switching switches 
has me baffled. The second chart should help demystify things. 
I show which switches to throw which way to make any particular 
range of memory come from the main 64K or the auxiliary bank. 
To keep the chart from growing beyond the page, I did not 
include the LCBANK, SLOTCX, or SLOTC3 switches. 


OBJ .APWRT] [F 


Detailed, complete, and rere os disassembly script 
includes full details on customizing Applewriter IIe 
and capturing your own source code for modification. 


Two unlocked, jammed-full and double-sided diskettes 
plus a free “must have" bonus book for only $29.95. 


SOURCECODE 

% Synergetics 

Box 1300-AAL 
Thatcher, AZ 85552 
(602) 428-4073 


VISA and MASTERCHARGE accepted. 
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Apple //e Soft Switches 


Status 0 1 

CO11 C08 (8=B) C08 (0-3) 

LCBANK Bank 1 Bank 2 
DOOO-DFFF 

C012 C081,2,9,A C080, 3,8,B 

LCRAM Select ROM select RAM 
DOOO-FFFF 

C013 co002 C003 

RAMRD Read Main Read Aux 
200-BFFF 

C014 C004 C005 

RAMWRT Write Main Write Aux 
200-BFFF 

C015 C006 C007 

SLOTCX Slot Internal 
C100-C7FF 

C016 coos C009 

ALTZP Main Aux 
O-1FF, DOOO-FFFF 

C017 COOA COOB 

SLOTC3 Internal Slot 
C300-C3FF, C800-CFFF 

c018 C000 co0o1 

8OSTORE RAMRD/RAMWRT PAGE2 
400-7FF, 2000-3FFF 

C019 

VBL in display in blanking 

CO1A c050 c051 

TEXT Graphics Text 

C0O1B c052 C053 

MIXED All Text or Mixed text 

all graphics & graphics 

CO1C C054 C055 

PAGE2 Page 1/Main Page 2/Aux 
hOO-7FF, 2000-3FFF 

CO1D C056 C057 

HIRES Lo-Res Hi-Res 


Status 0 1 

CO1E COOE COOF 

CHARSET Normal Alternate 

CO1F Cooc COOD 

80COL 40 Columns 80 Columns 

r++ + -$ + +-$-+-+ 4-4-4 ++ +--+ +--+ 3 $4 tf tt tt ty t+ t+ tt yt} 

Address Main Memory Aux Memory 

t+ +--+ 4-2-4 +--+ 4-3-2 -+-+ + -$ 3 7 te tt tt + + tt + tt ty tt et tt tj 

EOOO-FFFF C008 ALTZP=0 C009 ALTZP=1 
C080, 3,8,B C080, 3,8,B 

LCRAM= 1 LCRAM=1 


KOOO-BFFF Read: C002 Read: C003 

Write: COO4 Write: C005 
2000-3FFF C001 80STORE=1 

C057 HIRES=1 

CO54% PAGE2=0 


C057 HIRES=1 
C055 PAGE2=1 


or 
C000 BOSTORE=0 C000 80STORE=0 
Read: C002 Read: C003 
Write: C004 Write: C005 
or 
C056 HIRES=0 C056 HIRES=0 
Read: C002 Read: C003 
Write: COO4 Write: C005 
800-1FFF Read: C002 Read: C003 
Write: COO4 Write: C005 
400-7FF C001 80STORE=1 C001 80STORE=1 
C054 PAGE2=0 C055 PAGE2=1 
or 
C000 80STORE=0 C000 80STORE=0 
Read: C002 Read: C003 
Write: COO4 Write: C005 
200~3FF Read: C002 Read: C003 
Write: COO4 Write: C005 
0-1FF C008 ALTZP=0 C009 ALTZP=1 
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C001 80STORE=1 


Text Area Erase Routine... .ccccccccccccccccceseeteff Creamer 
Yavapai College, Prescott AZ 


Good programs interact frequently with their users, providing 
error messages, helpful prompts, and information about what the 
program is doing. For programmers, this raises the question of 
what to do with the messages once they have been printed, 
especially if you want to get rid of them while leaving the 
rest of the screen intact. 


I have used several strategies to clear specific areas of the 
text screen. The simplest solution, and probably the most 
commonly used, is to place all messages at the end of the page. 
Then you can HTAB and VTAB to the first character of the 
message and CALL the Monitor routine at $FC42 (CLREOP). From 
Applesoft, CALL -958. Such messages must be kept to the lower 
part of the screen, however, and the method can interfere with 
decorative borders, etc., placed around your screens. 


Another thing I have done is to print strings of blanks over 
the offending message. I use a loop to HTAB and VTAB to the 
left margin of the message area, incrementing the vertical 
coordinate each time, then printing a string variable set to a 
predetermined number of blanks. This method is slow, but not 
unbearable. Still, it is clumsy and wastes memory storing the 
blanks. 


Of course, instantaneous clears of a given area are easily done 
by resetting the text window through POKEing values to 
locations $25-$28, then executing a HOME. This requires 
POKEing 4 values before the clear, however, and POKEing 4 
coordinates to reset the current window when you are done (or 
"TEXT" to reset the default window). Downright unpleasant. 

For a time I resorted to this method to protect my decorative 
borders, however. 


Now I have come up with a routine that I think is an 
improvement over the above. It clears rectangular areas of the 
text screen given the width and depth (number of lines) needed. 
Because it uses the Monitor COUT routine, it should also work 
with those hi-res character generator utilities that interface 
to the normal output hooks, giving a controlled hi-res screen 
Clear. While it requires Applesoft in ROM, it is fully 
relocatable, making it ideal for people who use Ampersand 
utilities like AmperMagic or The Routine Machine. 


The routine, which I call "ERASE", is used by first HTABing and 
VTABing to the upper left corner of the area to be cleared. 
Then CALL the routine giving the width and depth of the area to 
be cleared, using commas, like so: 


CALL ADDRESS ,WIDTH,DEPTH 
For example, assume you BLOAD the routine at $300, the most 
common place to do such things. (At least while we are testing 
the program.) Then, to clear an area 15 characters wide by 4 
lines deep, write: 


CALL 768,15,4 
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E NEW TIMEMASTER II 


mam 


NEW 1984 
DESIGN 

An official 
PRO-DOS Clock 


Automatically date 
stamps files with 
PRO-DOS 


Sa $PESELES ERS 
@ Just plug it in and your programs can read the year, month, date, day, 
and time to 1 millisecond! The only clock with both year and ms. 
@ NiCad battery keeps the TIMEMASTER II running for over ten years. 
@ Full emulation of ALL other clocks. Yes, we emulate Brand A, BrandT, 
Brand P, Brand C, Brand S and Brand M too. It’s easy for the 
TIMEMASTER to emulate other clocks, we just drop off features. 
That’s why we can emulate others, but others CAN’T emulate us. 
@ The TIMEMASTER II will automatically emulate the correct clock card 
for the software you're using. You can also give the TIMEMASTER Ila 
simple command to tell it which clock to emulate (but you'll like the 
Timemaster mode better). This is great for writing programs for those 
poor unfortunates that bought some other clock card. 
@ Basic, Machine Code, CP/M and Pascal software on 2 disks! 
@ Eight software controlled interrupts so you can execute two programs 
at the same time (many examples are included). 
@ Orboard timer lets you time any interval up to 48 days long down to 
the nearest millisecond. 
The TIMEMASTER 11 includes 2 disks with some really fantastic time oriented 
programs (over 40) including appointment book so you'll never forget to do anything 
again. Enter your appointments up to a year in advance then forget them. Plus DOS 
dater so it will automatically add the date when disk files are created of modified. The 
disk is over a $200.00 .alue alone—we eive the software others sell. All software 
packages for business. data base management and communications are made to 
read the TIMEMASTER |. If you want the most powerfu! and the easiest to use clock 
for vour Apple. vou want a TIMEMASTER |i. 
PRICE $129.00 


Z-80 PLUS! 


¢ 
poems « 


f 
= = 
5 


@ TOTALLY compatible with ALL CP/M software. 

@ The only Z-80 card with a special 2K “CP/M detector’ chip. 

@ Fully compatible with microsoft disks (no pre-boot required). 

@ Specifically designed for high speed operation in the Apple Ile (runs 
just as fast in the II+ and Franklin). 


Apple Peripherals Are All We Make 


That’s Why We’re So Good At It! 


Super Music Synthesizer 
Improved Hardware and Software 


@ Complete 16 voice music synthesizer on one card. Just plug it into 
your Apple, connect the audio cable (supplied) to your stereo, boot 
the disk supplied and you are ready to input and play songs. 

@ It’s easy to program music with our compose software. You will start 
right away at inputting your favorite songs. The Hi-Res screen shows 
what you have entered in standard sheet music format 

@ Now with new improved software for the easiest and the fastest 
music input system available anywhere. 

We give you lots of software. In addition to Compose and Play 
programs, 2 disks are filled with over 30 songs ready to play. 

@ Easy to program in Basic_to generate complex sound effects. Now 
your games can have explosions, phaser zaps, train whistles, death 
cries. You name it, this card can do it 

@ Four white noise generators which are great for sound effects. 

@ Plays music in true stereo as well as true discrete quadraphonic. 

@ Full control of attack, volume, decay, sustain and release. 

@ Will play songs written for ALF synthesizer (ALF software will not take 
advantage of all our card’s features. Their software sounds the same 
in our synthesizer.) 

@ Our card will play notes from 30HZ to beyond human hearing. 

@ Automatic shutoff on power-up or if reset is pushed. 

® 


Many many more features. PRICE $159.00 


Viewmaster 80 

There used to be about a dozen 80 column cards for the Apple, now 

there’s only ONE. 

@ TOTALLY Videx Compatible. 

@ 80 characters by 24 lines, with a sharp 7x9 dot matrix. 

@ On-board 40/80 soft video switch with manual 40 column override 

@ Fully compatible with ALL Apple languages and software—there are 
NO exceptions. 

@ Low power consumption through the use of CMOS devices. 

®@ All connections are made with standard video connectors. 

@ Both upper and lower case characters are standard. 

@ All new design (using a new Microprocessor based C.R.T. controller 
for a beautiful razor sharp display. 

@ The VIEWMASTER incorporates all the features of all other 80 column 
casds, plus many new improvements. 


@ Runs WORD STAR, dBASE II, COBOL-80, FORTRAN-80, ruct ormucn Sproat ‘Smunce™ Thea” rem “nurs “Gotueee' cuaaacreas 
PEACHTREE and ALL other CP/M software with no pre-boot VIEWMASTER = 179 ves VES YES) VES VES, «VES VES vES 
@ A semi-custom I.C. and a low parts count allows the Z-80 Plus to fly aint ee ne ae ae = ue =e ve a 

es Wi N . ‘ 

ee we PANT OM DONEC E Ure reat ieee VISIONBO MORE ws vis NO NO YS NO NO NO 
: : OMNIVISION MORE NO YES NO SO NO NO YES YES 
@ Does EVERYTHING the other Z-80 boards do, plus Z-80 interrupts. AIWKUASEN- “MORE wfSYfS NO. NO. VIS. XO. NO ves 
; < : SMARTERAL = MORE vis vfs NO NO NO YES YES NO 
Don’t confuse the Z-80 Plus with crude copies of the microsoft card. The VIDLOTERM = MORE “ONO YES NO. YES YES NO YES 


Z-80 Plus employs a much more sophisticated and reliable design. With 
the Z-80 Plus you can access the largest body of software in existence. 
Two computers in one and the advantages of both, all at an unbelievably 


low price. PRICE $139.00 


MemoryMaster He 128K RAM Card 
@ Precision software disk emulation for Basic, Pascal and CP/M is 


The VIEWMASTER 80 works with all 80 column applications including CP/M, 
Pascal, WordStar, Format tl, Easywriter, Apple Writer II, VisiCalc, and all 
others. The VIEWMASTER 80 is THE MOST compatible 80 column card you 


can buy at ANY price! PRICE $179.00 


Expands your Apple Ile to 192K memory. 
Provides an 80 column text display. 


Compatible with all Apple Ile 80 column and extended 80 column 
card software (same physical size as Apple’s 64K card). 

Can be used as a solid state disk drive to make your programs run up 
to 20 times FASTER (the 64K configuration will act as half a drive). 
Permits your Ile to use the new double high resolution graphics. 
Automatically expands Visicalc to 95 K storage in 80 columns! The 
64K config. is all that’s needed, 128K can take you even higher. 
PRO-DOS will use the MemoryMaster Ile as a high speed disk drive. 


available at a very low cost. NOT copy protected. 
@ Documentation included, we show you how to use all 192K. 


If you already have Apple’s 64K card, just order the MEMORYMASTER Ile with 64K and use 
the 64K from your old board to give you a full 128K. (The board is fully socketed so you 
simply plug in more chips.) 


MemoryMaster fle with 128K $249 
Upgradeable MemoryMaster Ile with 64K $169 
Non-Upgradeable MemoryMaster Ile with 64K $149 


Our boards are far superior to most of the consumer electronics made today. Alll.C.’s are in high quality sockets with mil-spec. components used throughout. P.C. boards are glass- 
epoxy with gold contacts. Made in America to be the best in the world. All products work in the APPLE HE, Il, 1+ and Franklin, The MemoryMaster Weis tle only. Applied Engineering 
also manufactures a full line of data acquisition and control products for the Apple; A/D converters and digital I/O cards, etc. Please call for more information. All our products are fully 
tested with complete documentation and available for immediate delivery. All products are guaranteed with a no hassle THREE YEAR WARRANTY. 


Send Check or Money Order to: 
APPLIED ENGINEERING 
P.O. Box 798 
Carrollton, TX 75006 


Texas Residents Add 5% Sales Tax 
Add $10.00 If Outside U.S.A. 
Dealer Inquiries Welcome 


Call (214) 492-2027 . 
8 am. to 11 p.m. 7 days a week 
MasterCard, Visa & C.0.D. Welcome 
No extra charge for credit cards 
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The command shown above uses simple constants, but ERASE can 
handle any quantities “width" and “depth" up to formulas as 
complex as those Applesoft can normally handle. (I can't brag 
about that part, since all the work is done by Applesoft's 
formula evaluation routine “FRMEVL", called indirectly in my 
program by the "JSR GETBYT". 


In case you don't have John Crossley's article on Applesoft 
Internal Entry Points, GETBYT is a subsidiary routine that 
evaluates formulas, bringing back a single-byte integer in the 
X-register and in location SAl--"FACLO". I don't use “FACLO" 
in this routine. GETBYT gives an illegal quantity error if the 
formula evaluates to more than 255 or less than 0.) 


If you specify a width or depth of zero, ERASE will give an 
illegal quantity error. If the width of the line goes past the 
right edge of the screen, the blanks will wrap around the 
screen on the next line down. ERASE will pick up at the 
correct horizontal/vertical location when clearing subsequent 
lines, however. If the area to be erased goes past the bottom 
of the screen, do not fear: ERASE wraps around to the top of 
the screen. Your program and variables will not be hurt. 


Here is a short Applesoft program that demonstrates ERASE in 
action. The program first fills the entire screen with 
asterisks, and then clears three windows. The first window 
wraps around from the right edge of the screen to the left. 
The second wraps around from the bottom to the top. The third 
is in the middle of the screen. (I am assuming a 40-column 
screen here.) 


100 FOR I = 1 TO 24: PRINT 
HEKKEAERERRERAREREKERREREREREREREREEEERERG!? 2 NEXT 

110 HTAB 30: VTAB 10: CALL 768,20,5 

120 HTAB 10: VTAB 20: CALL 768,20,8 

130 HTAB 15: VTAB 10: CALL 768,10,5 


And here is another demo, one which is closer to the way you 
will find yourself using ERASE. This one prints an array of 
six messages in six windows on the scrren, and lets you 
selectively erase them in any order one-by-one. As it turned 
out, the way I located the upper corners of the messages 
involved some lengthy formulas, but these ended up in the HTAB 
and VTAB statements. Note that I could have used data 
statements for similar results. 


ana PRINT CHRS (4 (4); "BLOAD ERASE*® 
HOME 


190 PRINT: * AREA #1 AREA #2 AREA #3* 
Fe ee 
@ 

HO VTE 2 ae 
AREA #5 AREA #6" 

160 PRINT © THAT'S AT YOUR IS ALSO* 

170 PRINT ® ME | SERVICE! GREAT. * 

180 HTAB 15: VTAB 20 

190 PRINT *ERASE WHICH?";: GET A$ 

200 ON ASC 2 13 Go coto 260 

510 A= VAL Ad}: ONPA <1 OR A > 6 GOTO 180 


220 HTAB 12 # INT 5(f4- : ys : Pr INT ((A - 1) / 3)) ® 3 + .05)) + 3 


200 HOME : VTAB 20: PRINT "BYE!": END 
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1000 SSAVE S.ERASE (JEFF CREAMER) 

1020 # ® 

1030 ® ERASE ROUTINE & 

1040 # # 

1050 ® Jeff Creamer # 

1060 # # 

19 0 ® CALL 768,(WIDTH),(DEPTH) 

1090 Giummen @@ 2 GE Ge > GD Gm E> Op Ue Geo Ga Ge Ge GP Ga GS Ge & > > = GP GP Gs SS EZ 

1100 & PAGE ZERO VARIABLES 
0024- 1120 MON.CH EQ $24 
0025- 1130 MON .CV .EQ $25 

1190 * APPLESOFT ROUTINES USED 
DEBE- 1170 AS.CHKCOM .EQ $DEBE 
E6FB- 1180 AS.GETBYT .EQ 3E6F8 
E199- 1190 AS.IQERR .EQ $E199 

1210 " MONITOR ROUTINES USED 
FC22- 1230 MON.VTAB  .EQ gEC22 
FOhA- 12 0 MON.PREL2 .EQ $F94A 

1320 .OR $300 

1270 .TF ERASE 

1280 Siaasteacenmaceureeeneces nm maeneaeanwe 

1290 e JEFF'S ERASE ROUTINE 
0300- A 25 1310 ERASE LDA MON.CV GET VERTICAL COORD 
0302- 4 1320 P SAVE ON STACK 
0303- 42 2h Ss‘ 1330 LDA MON.CH AND HORIZ COORD 
0 05- k 1340 PHA SAVE IT ON STACK, TOO 
0306- 20 BE DE 1350 JSR AS.CHKCOM COMMA 
0309- 20 F8 E6 1 60 JSR AS.GETBYT YES, GET WIDTH TO ERASE 
030C- 8A 137 TXA INTO ACC 7 
030D- FO 3A —Ss: 1380 BEQ .4 WIDTH MUST BE NON-ZERO 
O30F- 48 1390 PHA PUSH WIDTH ON STACK 
0310- 20 Bg DE 1400 JSR AS.CHKCOM COMMA NEXT? 
0313- 20 F8 E6 1410 JSR AS.GETBYT | YES, GET DEPTH 
0316- 8A 1420 TXA AND TRANSFER TO ACC 
0317- FO 30 1430 BEQ .4 DEPTH MUST BE NON-ZERO 
0319- A 14 TAY DEPTH INTO Y REGISTER 
031A- 68 1450 PLA WIDTH BACK OFF STACK 
031B- 48 1460 PHA BUT KEEP IT THERE ALSO 
031C- AA 1470 TAX AND INTO X-REG 
0 1D 42 25 1480 1 LDA MON.CV —sREMEMBER CV ON STACK 
0320- 20 4A F9 1500 JSR MON .PRBL2 PRINT WIDTH # OF BLANKS 
0323- 8 1510 PLA GET OLD CV OFF STACK 
032%~ 88 1520 DEY DECREMENT DEPTH 
0325- FO 17 1530 BEQ .3 ZERO LINES LEFT? 
0327- AA 1540 TAX OLD CV INTO X-REGISTER 
0328- E8 1550 INX NEXT LINE 
0329- EO 18 1560 CPX #24 OFF THE BOTTOM? 
032B- 90 02 1570 BCC .2 NO, USE THIS ONE 
ere, Ae OE ey es SER OM TO OP 
03 1- 20 22 FC 1600 JSR MON.VTAB ADJUST BASE ADDRESS 
0334- 68 1610 PLA WIDTH OFF STACK 
0335- AA 1620 TO SET UP X AGAIN 
0336- 68 1630 PLA HORLZ COORD OFF STACK 
0337 hg 16 0 PHA BUT MAINTAIN IT THERE ALSO 
0338- 85 2h 1650 STA MON.CH AND RESTORE HCURSOR 
0 3A- SA 1660 TXA PUSH WIDTH BACK ON STACK 
033B- 48 1670 PHA FOR NEXT TIME AROUND 
033¢- DO DF —- 16 80 BNE .1 LOOP ALWAYS 
033E- 68 1690 .3 PLA POP WIDTH OFF 
03 3F- 68 1700 PLA GET HORIZ COORDINATE 
0340- 85 24 = 1710 STA MON.CH AND RESTORE IT 
0342- 1720 PLA GET VERTICAL COOORDINATE 
0343- 85 25 1730 STA MON.CV IT, TO 
O34 m 20 22 FC I7ho JSR MON .VTAB ome Deus! BASE ADDRESS 
0349- 4C 99 E1 1760 .4 JMP AS.IQERR ILLEGAL QUANTITY ERROR 
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With these tools you can really program! 


Presenting a selection of the best programming tools for the entire Apple II family! 


S-C Macro Assembler-— Combined  editor/assem- 
bler includes 29 commands and 20 directives; with 
macros, conditional assembly, global replace, edit, and 
more. Well-known for ease-of-use and powerful features. 
Thousands of users in over 30 countries and in every type 
of industry attest to its speed, dependability, and user- 
friendliness. Blends power, simplicity, and performance to 
provide the optimum capabilities to both beginning and 
professional programmers. With 100-page manual and 
reference card, $80. (If you own an older version, call for 
an upgrade price.) 


Cross Assembler Modules — Owners of the S-C Macro 
Assembler may add the ability to develop programs for 
other systems. We have modules for most of the popular 
chips, at very reasonable prices: 


All of the cross assemblers retain the full power of the S-C 
Macro Assembler. You can develop programs for burning 
into EPROMs, transfer through a data-link, or direct 
execution by some of the plug-in processor cards now on 
the market. 


Apple Assembly Line — Monthly newsletter for assembly 
language programmers, beginner or advanced. Tutorial 
articles; advanced techniques; handy utility programs; 
commented listings of code in DOS and Apple ROMs; 
reviews of relevant new books, hardware, software; and 
more! $18 per year (add$3 for first class postage in USA, 
Canada, Mexico; add $13 postage for other countries). 


ES-CAPE (Extended S-C Applesoft Program Editor) 
- Full-function, interactive program editor for Applesoft. 


S-C Software Corporation 
2331 Gus Thomasson, Suite 125 


Dallas, Texas 75228 
(214) 324-2050 


We take Mastercard, Visa, and American Express 


Apple is a trademark of Apple Computer 


For painless programming and accurate entry of programs 
from magazines: fast, easy changes; split-screen operation; 
global search and replace; automatic line numbers; key- 
board macros; and more! $60 


Flash! — The Integer BASIC Compiler from Laumer 
Research. Transforms your programs into machine !an- 
guage so they run many times faster. Adds many new 
functions and features to the language, supporting hi-res 
graphics and more! Optional assembly source code crea- 
tion for use with S-C Assembler. Requires Integer BASIC 
in RAM or ROM to edit source programs (not required for 
compiled programs). Source code of run-time package 
also available. Compiler, $79; run-time source, $39. 


Double Precision Floating Point for Applesoft — For 
the scientist or engineer who is not satisfied with Apple- 
soft’s nine-digit precision. With this 2048-byte machine 
language extension to Applesoft, you can get 21-digit 
precision whenever you need it! Supports +, —, *, /, 
INPUT, and PRINT. Subroutines coded in Applesoft for 
21-digit precision math functions (sin, cos,sqrt, log, exp, 
etc.) are also included. And it’s fast! Only $50. 


DISASM - Symbolic two-pass disassembler handles data 
tables, displaced object code, and includes a pre-defined 
symbol table of your choice. Produces ready-to-assemble 
source code with labels from machine code in ROM or 
RAM, formatted for S-C, Lisa, or ToolKit assemblers. 
$30. 


S-C XREF - Designed to work with the S-C Macro 
Assember, produces a cross reference table of all labels 
used in your assembly source code. Only $20, or $50 with 
complete source code on disk. 


All of our products are designed to be used. You can make back- 
up copies with any standard Apple disk copy program, and copies 
of the individual files can be moved to your working disks. We 
trust you. 

S-C Software Corporation has frequently been commended for 
outstanding support: competent telephone help, continuing en- 
hancements, and excellent upgrade policies. Call now.and talk to 
Bob Sander-Cederlof or Bill Morgan. We want to help you 
program! 
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The Amazing “quikLoader" Card.........e+ee.+.eBOb Sander-Cederlof 


Jim Sather, author of "Understanding the Apple II", has 
designed and programmed a great new plug-in. It is basically a 
ROM card, but hold on to your hats! 


The card has sockets for 8 EPROMs, and they can be any EPROM 
size from 2716 up through 27256. That means the card can hold 
a up to 256 kilobytes! 


The card comes loaded already with three 2764 devices, 
programmed with licensed copies of DOS 3.3, FID, COPYA, the 
quikLoad operating system, and possibly more. I think Integer 
BASIC is on there too. With DOS on the card, you can leave it 
off your disks. You gain at least two tracks per disk this 
way. 


The quikLoad operating system allows you to load any program 
from the card into RAM in a flash. If you have an EPROM 
programmer that can burn 2764s or larger, you can put favorites 
like the S-C Macro Assembler and our word processor permanently 
there. The programs don't even have to be modified, because 
they will be loaded into their normal RAM locations for 
execution. 


You control the card by typing a control character along with 
RESET. For example, ctr1-C RESET catalogs a disk; ctrl1-H RESET 
runs “HELLO"; others boot a disk or enter the monitor. Ctr1-Q 
RESET gives you a catalog of your quikLoader ROMs, in the form 
of a menu; a single keystroke then selects a program. 


The board is compatible with Apple II, II Plus, and //e. Ina 
II Plus with a 16K RAM card, you may need to perform a slight 
modification to the RAM card as explained in the documentation. 


The boards are being manufactured by Southern California 
Research Group (SCRG), P. O. Box 2231, Goleta, CA 93118. Phone 
(805) 685-1931. Their price is $179.50. You can order them 
from us if you like, at $170 + shipping. 


International Personal Robotics Conference 


If you are among the many experimenting with little personal 
robots, such as Heathkit's HERO, you may be interested in 
attending the above named conference in Albuquerque next April 
13-15. They are expecting around 4000 to show up from all over 
the world. You can meet such well known robotics experts as 
Joseph Engleberger, Nels Winless and others. It's a fair bet 
you'll find Jack Lewis of Micromation there. For more info, 
call Betty Bevers of IRPC at (303) 278-0662, or write to them 
at 1547 South Owens St. #46, Lakewood, Colorado 80226. 
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Macro to Generate Quotient/Remainder Table for Hi-Res Work 
ee vee Wes de ee «eee ewe BOD Sander-Cederlof 


A few months back an article in Byte magazine presented some 
fast hi-resolution plotting routines. One of the secrets to 
fast plotting is table lookup rather than computation of base 
addresses and offsets. The article included a 560 byte table 
for all the possible quotients and remainers you can get when 
dividing X by 7, where X is the horizontal coordinate (0 to 
279). | 


The table of quotients and remainders makes it easy to get the 
byte position on a line (quotient) and the bit position in the 
byte (remainder) for a given dot X-coordinate. 


Typing a 560 byte table into the computer is no fun, no matter 
how you do it. You might go into the monitor and type directly 
in hex, then later BSAVE the table. Or you might use an 
Applesoft program to build the table. I think the easiest way 
is to write a few short macros, and let the assembler do the 
work. 


If you have Version 1.1 of the S-C Macro Assembler, the 
following code will do the trick. Version 1.0 cannot handle 
it, because the nesting level goes too deep. The listing it 
prints out gets quite long, due to all the macro expansion. 
Therefore I am just printing the source code here. The table 
it produces is also long, so I am just showing the beginning 
and end of it. 


19 0 OF X/7, WHERE X=0...25 

19 : MA 0.QS 

19 5 Q 5D0.RS 

1090 -DO Q 

46 a 0800- 00 00 00 01 00 02 00 03 
1120 EM 0808- 00 04 00 05 00 06 10 00 
UF ea eee MA DO-RS Ob GD ED ED EP ED ED Om GD Eb E> GS Ss tan OD aD 0810- 01 01 01 02 01 03 01 04 
Heo R : £9, 0A18= 26 02 26 03 26 O4 26 05 
1170 ~DO R<7 OA20- 06 27 00 37 01 27 02 
1180 DO.RS OA28- 27 03 27 O48 27 05 27 06 
a 

1910 Seeecee concerto cece tee 

1220 Q -SE 0 

1230 >D0.QS 

12 ft neeeseseee ss ee he el is lone eh te in eh ag 
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